AI SDK Kotlin/ai.torad.aisdk/ToolExecutionContext

ToolExecutionContext

class ToolExecutionContext<TContext>(val context: TContext?, val abortSignal: AbortSignal, val stepNumber: Int, val messages: List<ModelMessage>, val toolCallId: String, val writer: ToolStreamWriter = NoopToolStreamWriter)

What Tool.execute sees as this. Holds the typed application context (whatever the agent's callOptionsSchema says) plus the abort signal (invariant I-10: subagent tool handlers MUST forward this), the current step number, and the running message list.

Constructors

constructor(context: TContext?, abortSignal: AbortSignal, stepNumber: Int, messages: List<ModelMessage>, toolCallId: String, writer: ToolStreamWriter = NoopToolStreamWriter)

Properties

abortSignal

val abortSignal: AbortSignal

context

val context: TContext?

messages

val messages: List<ModelMessage>

stepNumber

val stepNumber: Int

toolCallId

val toolCallId: String

The current tool call's id. Mirrors v6's ToolExecutionOptions.toolCallId. Lets a tool self-identify for tracing, telemetry, or streaming-progress writes (paired with writer).

writer

val writer: ToolStreamWriter

Writes custom events into the agent's active output stream (gap #21). The loop supplies a real writer bound to the output flow; defaults to NoopToolStreamWriter when a context is constructed outside the loop.